home *** CD-ROM | disk | FTP | other *** search
/ Archive Magazine CD 1995 / Archive Magazine CD 1995.iso / discs / prog_disc / volume_2 / issue_06 / scott / text / xcopy_t < prev   
Encoding:
Text File  |  1989-02-11  |  2.6 KB  |  67 lines
  1.                             XCOPY Release 1
  2.  
  3.                               David Scott
  4.  
  5. Introduction
  6.  
  7. XCOPY  is  a  utility  program  which  provides  backup  facilities  for 
  8. Archimedes ADFS file structures. It may be used to provide either a full 
  9. back  up  of  a particular directory or hierarchy of  directories  or  a 
  10. selective  back  up in which only those files which  have  been  updated 
  11. since the last back up are copied.
  12.  
  13. In  the selective mode of operation the program checks the file  details 
  14. on  the  destination disc and only copies a file from the source  if  it 
  15. differs  in  length,  file  type  or  date or  does  not  exist  on  the 
  16. destination disc.  This means that a backup can often be completed  very 
  17. quickly since the checking only takes a fraction of the time that  would 
  18. be required to make a full copy.
  19.  
  20. The  program  normally displays a monitor message about  each  operation 
  21. although  an option allows this to be turned off.  It concludes  with  a 
  22. message  giving  the amount of free space available on  the  destination 
  23. disc.
  24.  
  25. The  release and issue numbers of the program and a short help text  can 
  26. be displayed by calling the program without any parameters.
  27.  
  28. The program is written in C and is available as a machine code file  for 
  29. running on the Archimedes.
  30.  
  31. Commands
  32.  
  33. The  operation of the program is controlled by the parameters  given  in 
  34. the command line when calling the program.
  35.  
  36. The syntax for the command line is:
  37.  
  38.       *XCOPY [<source path name>] [<destination path name>] [options]
  39.  
  40. If  no parameters or a faulty parameter is given then the help  text  is 
  41. displayed.
  42.  
  43. The default source drive and directory name is ':4.$'.  If another drive 
  44. is  required  then  it must be specified explicitly.  If  the  drive  is 
  45. correct  but a different source directory is required then this  may  be 
  46. specified without specifying the drive.
  47.  
  48. The default destination drive and directory name is ':0.$'.  If  another 
  49. drive is required then it must be specified explicitly.  If the drive is 
  50. correct but a different destination directory is required then this  may 
  51. be specified without specifying the drive.
  52.  
  53. Options are specified by a hyphen followed by a single letter:
  54.  
  55. -c    Confirm  with  the user before each item is copied to  or  deleted 
  56.       from the destination.
  57.  
  58. -f    Full copy required. The default mode copies only files which  have 
  59.       changed.
  60.  
  61. -r    Cancel  the recursive option so that the  default copying  of  all 
  62.       subdirectories as well as the directory specified is suppressed.
  63.  
  64. -v    Cancel  the  standard verbose option so  that  monitoring  of  all 
  65.       operations on the screen is suppressed.
  66.  
  67.